<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>perlsynology - Perl 5 on Synology DSM systems - Perldoc Browser</title>
    <link rel="search" href="https://perldoc.perl.org/opensearch.xml" type="application/opensearchdescription+xml" title="Perldoc Browser">
    <link rel="canonical" href="https://perldoc.perl.org/perlsynology">
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css" integrity="sha384-JcKb8q3iqJ61gNV9KGb8thSsNjpSL0n8PARn9HuZOnIxN0hoP+VmmDGMN5t9UJ0Z" crossorigin="anonymous">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.5.0/styles/stackoverflow-light.min.css" integrity="sha512-cG1IdFxqipi3gqLmksLtuk13C+hBa57a6zpWxMeoY3Q9O6ooFxq50DayCdm0QrDgZjMUn23z/0PMZlgft7Yp5Q==" crossorigin="anonymous" />
    <style>
      body {
        background: #f4f4f5;
        color: #020202;
      }
      .navbar-dark {
        background-image: -webkit-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: -o-linear-gradient(top, #005f85 0, #002e49 100%);
        background-image: linear-gradient(to bottom, #005f85 0, #002e49 100%);
        filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#ff005f85', endColorstr='#ff002e49', GradientType=0);
        background-repeat: repeat-x;
      }
      .navbar-dark .navbar-nav .nav-link,
      .navbar-dark .navbar-nav .nav-link:focus { color: #fff }
      .navbar-dark .navbar-nav .nav-link:hover { color: #ffef68 }
      #wrapperlicious {
        margin: 0 auto;
        font: 0.9em 'Helvetica Neue', Helvetica, sans-serif;
        font-weight: normal;
        line-height: 1.5em;
        margin: 0;
        padding: 0;
      }
      #wrapperlicious h1 { font-size: 1.5em }
      #wrapperlicious h2 { font-size: 1.3em }
      #wrapperlicious h3 { font-size: 1.1em }
      #wrapperlicious h4 { font-size: 0.9em }
      #wrapperlicious h1, #wrapperlicious h2, #wrapperlicious h3,
      #wrapperlicious h4, #wrapperlicious dt {
        color: #020202;
        margin-top: 1em;
        margin-bottom: 1em;
        position: relative;
        font-weight: bold;
      }
      #wrapperlicious a { color: inherit; text-decoration: underline }
      #wrapperlicious #toc { text-decoration: none }
      #wrapperlicious a:hover { color: #2a2a2a }
      #wrapperlicious a img { border: 0 }
      #wrapperlicious :not(pre) > code {
        color: inherit;
        background-color: rgba(0, 0, 0, 0.04);
        border-radius: 3px;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        padding: 0.3em;
      }
      #wrapperlicious dd {
        margin: 0;
        margin-left: 2em;
      }
      #wrapperlicious dt {
        color: #2a2a2a;
        font-weight: bold;
        margin-left: 0.9em;
      }
      #wrapperlicious p {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious li > p {
        margin-bottom: 0;
        margin-top: 0;
      }
      #wrapperlicious pre {
        border: 1px solid #c1c1c1;
        border-radius: 3px;
        font: 100% Consolas, Menlo, Monaco, monospace;
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious pre > code {
        display: block;
        background-color: #f6f6f6;
        font: 0.9em Consolas, Menlo, Monaco, monospace;
        line-height: 1.5em;
        text-align: left;
        white-space: pre;
        padding: 1em;
      }
      #wrapperlicious dl, #wrapperlicious ol, #wrapperlicious ul {
        margin-bottom: 1em;
        margin-top: 1em;
      }
      #wrapperlicious ul {
        list-style-type: square;
      }
      #wrapperlicious ul ul {
        margin-bottom: 0px;
        margin-top: 0px;
      }
      #footer {
        font-size: 0.8em;
        padding-top: 0.5em;
        text-align: center;
      }
      #more {
        display: inline;
        font-size: 0.8em;
      }
      #perldocdiv {
        background-color: #fff;
        border: 1px solid #c1c1c1;
        border-bottom-left-radius: 5px;
        border-bottom-right-radius: 5px;
        margin-left: auto;
        margin-right: auto;
        padding: 3em;
        padding-top: 1em;
        max-width: 960px;
      }
      #moduleversion { float: right }
      #wrapperlicious .leading-notice {
        font-style: italic;
        padding-left: 1em;
        margin-top: 1em;
        margin-bottom: 1em;
      }
      #wrapperlicious .permalink {
        display: none;
        left: -0.75em;
        position: absolute;
        padding-right: 0.25em;
        text-decoration: none;
      }
      #wrapperlicious h1:hover .permalink, #wrapperlicious h2:hover .permalink,
      #wrapperlicious h3:hover .permalink, #wrapperlicious h4:hover .permalink,
      #wrapperlicious dt:hover .permalink {
        display: block;
      }
    </style>
    <!-- Global site tag (gtag.js) - Google Analytics -->
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-KVNWBNT5FB"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());

      gtag('config', 'G-KVNWBNT5FB');
      gtag('config', 'UA-50555-3');
    </script>
  </head>
  <body>
    <nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <a class="navbar-brand" href="https://perldoc.perl.org/">Perldoc Browser</a>
  <div class="collapse navbar-collapse" id="navbarNav">
    <ul class="navbar-nav mr-auto">
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlsynology.html#" id="dropdownlink-stable" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">5.35.0</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-stable">
          <a class="dropdown-item" href="https://perldoc.perl.org/perlsynology">Latest</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.2/perlsynology">5.38.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.1/perlsynology">5.38.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0/perlsynology">5.38.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.3/perlsynology">5.36.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.2/perlsynology">5.36.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.1/perlsynology">5.36.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.36.0/perlsynology">5.36.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.3/perlsynology">5.34.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.2/perlsynology">5.34.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.1/perlsynology">5.34.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.34.0/perlsynology">5.34.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.1/perlsynology">5.32.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.32.0/perlsynology">5.32.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.3/perlsynology">5.30.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.2/perlsynology">5.30.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.1/perlsynology">5.30.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.30.0/perlsynology">5.30.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.3/perlsynology">5.28.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.2/perlsynology">5.28.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.1/perlsynology">5.28.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.28.0/perlsynology">5.28.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.3/perlsynology">5.26.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.2/perlsynology">5.26.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.1/perlsynology">5.26.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.26.0/perlsynology">5.26.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.4/perlsynology">5.24.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.3/perlsynology">5.24.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.2/perlsynology">5.24.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.1/perlsynology">5.24.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.24.0/perlsynology">5.24.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.4/perlsynology">5.22.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.3/perlsynology">5.22.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.2/perlsynology">5.22.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.1/perlsynology">5.22.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.22.0/perlsynology">5.22.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.3/perlsynology">5.20.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.2/perlsynology">5.20.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.1/perlsynology">5.20.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.20.0/perlsynology">5.20.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.4/perlsynology">5.18.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.3/perlsynology">5.18.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.2/perlsynology">5.18.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.1/perlsynology">5.18.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.18.0/perlsynology">5.18.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.3/perlsynology">5.16.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.2/perlsynology">5.16.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.1/perlsynology">5.16.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.16.0/perlsynology">5.16.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.4/perlsynology">5.14.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.3/perlsynology">5.14.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.2/perlsynology">5.14.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.1/perlsynology">5.14.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.14.0/perlsynology">5.14.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.5/perlsynology">5.12.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.4/perlsynology">5.12.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.3/perlsynology">5.12.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.2/perlsynology">5.12.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.1/perlsynology">5.12.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.12.0/perlsynology">5.12.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.1/perlsynology">5.10.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.10.0/perlsynology">5.10.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.9/perlsynology">5.8.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.8/perlsynology">5.8.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.7/perlsynology">5.8.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.6/perlsynology">5.8.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.5/perlsynology">5.8.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.4/perlsynology">5.8.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.3/perlsynology">5.8.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.2/perlsynology">5.8.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.1/perlsynology">5.8.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.8.0/perlsynology">5.8.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.2/perlsynology">5.6.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.1/perlsynology">5.6.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.6.0/perlsynology">5.6.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_04/perlsynology">5.005_04</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_03/perlsynology">5.005_03</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_02/perlsynology">5.005_02</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005_01/perlsynology">5.005_01</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.005/perlsynology">5.005</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlsynology.html#" id="dropdownlink-dev" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Dev</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-dev">
          <a class="dropdown-item" href="https://perldoc.perl.org/blead/perlsynology">blead</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.6/perlsynology">5.39.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.5/perlsynology">5.39.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.4/perlsynology">5.39.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.3/perlsynology">5.39.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.2/perlsynology">5.39.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.39.1/perlsynology">5.39.1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC2/perlsynology">5.38.0-RC2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.38.0-RC1/perlsynology">5.38.0-RC1</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.11/perlsynology">5.37.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.10/perlsynology">5.37.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.9/perlsynology">5.37.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.8/perlsynology">5.37.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.7/perlsynology">5.37.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.6/perlsynology">5.37.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.5/perlsynology">5.37.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.4/perlsynology">5.37.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.3/perlsynology">5.37.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.2/perlsynology">5.37.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.1/perlsynology">5.37.1</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.37.0/perlsynology">5.37.0</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.11/perlsynology">5.35.11</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.10/perlsynology">5.35.10</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.9/perlsynology">5.35.9</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.8/perlsynology">5.35.8</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.7/perlsynology">5.35.7</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.6/perlsynology">5.35.6</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.5/perlsynology">5.35.5</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.4/perlsynology">5.35.4</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.3/perlsynology">5.35.3</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.2/perlsynology">5.35.2</a>
          <a class="dropdown-item" href="https://perldoc.perl.org/5.35.1/perlsynology">5.35.1</a>
          <a class="dropdown-item active" href="perlsynology.html">5.35.0</a>
        </div>
      </li>
      <li class="nav-item dropdown text-nowrap">
        <a class="nav-link dropdown-toggle" href="perlsynology.html#" id="dropdownlink-nav" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Documentation</a>
        <div class="dropdown-menu" aria-labelledby="dropdownlink-nav">
          <a class="dropdown-item" href="perl.html">Perl</a>
          <a class="dropdown-item" href="perlintro.html">Intro</a>
          <a class="dropdown-item" href="perl.html#Tutorials">Tutorials</a>
          <a class="dropdown-item" href="perlfaq.html">FAQs</a>
          <a class="dropdown-item" href="perl.html#Reference-Manual">Reference</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlop.html">Operators</a>
          <a class="dropdown-item" href="functions.html">Functions</a>
          <a class="dropdown-item" href="variables.html">Variables</a>
          <a class="dropdown-item" href="modules.html">Modules</a>
          <a class="dropdown-item" href="perlutil.html">Utilities</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="perlcommunity.html">Community</a>
          <a class="dropdown-item" href="perlhist.html">History</a>
        </div>
      </li>
    </ul>
    <ul class="navbar-nav">
      <script>
        function set_expand (expand) {
          var perldocdiv = document.getElementById('perldocdiv');
          var width = window.getComputedStyle(perldocdiv).getPropertyValue('max-width');
          var expanded = (width == '' || width == 'none') ? true : false;
          if (expand === null) {
            expand = !expanded;
          }
          if ((expand && !expanded) || (!expand && expanded)) {
            perldocdiv.style.setProperty('max-width', expand ? 'none' : '960px');
            var button_classlist = document.getElementById('content-expand-button').classList;
            if (expand) {
              button_classlist.add('btn-light');
              button_classlist.remove('btn-outline-light');
            } else {
              button_classlist.add('btn-outline-light');
              button_classlist.remove('btn-light');
            }
          }
          return expand;
        }
        function toggle_expand () {
          var expand = set_expand(null);
          document.cookie = 'perldoc_expand=' + (expand ? 1 : 0) + '; path=/; expires=Tue, 19 Jan 2038 03:14:07 UTC';
        }
        function read_expand () {
          return document.cookie.split(';').some(function (item) { return item.indexOf('perldoc_expand=1') >= 0 });
        }
        if (document.readyState === 'loading') {
          document.addEventListener('DOMContentLoaded', function () {
            if (read_expand()) {
              set_expand(true);
            }
          });
        } else if (read_expand()) {
          set_expand(true);
        }
      </script>
      <button id="content-expand-button" type="button" class="btn btn-outline-light d-none d-lg-inline-block mr-2" onclick="toggle_expand()">Expand</button>
    <ul>
    <form class="form-inline" method="get" action="https://perldoc.perl.org/5.35.0/search">
      <input class="form-control mr-3" type="search" name="q" placeholder="Search" aria-label="Search">
    </form>
  </div>
</nav>

    <div id="wrapperlicious" class="container-fluid">
      <div id="perldocdiv">
        <div id="links">
          <a href="perlsynology.html">perlsynology</a>
          <div id="more">
            (<a href="perlsynology.txt">source</a>,
            <a href="https://metacpan.org/pod/perlsynology">CPAN</a>)
          </div>
        </div>
        <div class="leading-notice">
          You are viewing the version of this documentation from Perl 5.35.0.
            This is a development version of Perl.
        </div>
        <h1><a id="toc">CONTENTS</a></h1>
                  <ul>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#NAME">NAME</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#DESCRIPTION">DESCRIPTION</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Setting-up-the-build-environment">Setting up the build environment</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#DSM-5">DSM 5</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#DSM-6">DSM 6</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Compiling-Perl-5">Compiling Perl 5</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Known-problems">Known problems</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Configure">Configure</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Build">Build</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Failing-tests">Failing tests</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Smoke-testing-Perl-5">Smoke testing Perl 5</a>
                            <ul>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Local-patches">Local patches</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#Adding-libraries">Adding libraries</a>
              </li>
          </ul>

              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#REVISION">REVISION</a>
              </li>
              <li>
                <a class="text-decoration-none" href="perlsynology.html#AUTHOR">AUTHOR</a>
              </li>
          </ul>

      <h1 id="NAME"><a class="permalink" href="perlsynology.html#NAME">#</a>NAME</h1>

<p>perlsynology - Perl 5 on Synology DSM systems</p>

<h1 id="DESCRIPTION"><a class="permalink" href="perlsynology.html#DESCRIPTION">#</a>DESCRIPTION</h1>

<p>Synology manufactures a vast number of Network Attached Storage (NAS) devices that are very popular in large organisations as well as small businesses and homes.</p>

<p>The NAS systems are equipped with Synology Disk Storage Manager (DSM), which is a trimmed-down Linux system enhanced with several tools for managing the NAS. There are several flavours of hardware: Marvell Armada (ARMv5tel, ARMv7l), Intel Atom (i686, x86_64), Freescale QorIQ (PPC), and more. For a full list see the <a href="https://forum.synology.com/wiki/index.php/What_kind_of_CPU_does_my_NAS_have">Synology FAQ</a>.</p>

<p>Since it is based on Linux, the NAS can run many popular Linux software packages, including Perl. In fact, Synology provides a ready-to-install package for Perl, depending on the version of DSM the installed perl ranges from 5.8.6 on DSM-4.3 to 5.24.0 on DSM-6.1.</p>

<p>There is an active user community that provides many software packages for the Synology DSM systems; at the time of writing this document they provide Perl version 5.24.1.</p>

<p>This document describes various features of Synology DSM operating system that will affect how Perl 5 (hereafter just Perl) is configured, compiled and/or runs. It has been compiled and verified by Johan Vromans for the Synology DS413 (QorIQ), with feedback from H.Merijn Brand (DS213, ARMv5tel and RS815, Intel Atom x64).</p>

<h2 id="Setting-up-the-build-environment"><a class="permalink" href="perlsynology.html#Setting-up-the-build-environment">#</a><a id="Setting"></a>Setting up the build environment</h2>

<h3 id="DSM-5"><a class="permalink" href="perlsynology.html#DSM-5">#</a><a id="DSM"></a>DSM 5</h3>

<p>As DSM is a trimmed-down Linux system, it lacks many of the tools and libraries commonly found on Linux. The basic tools like sh, cp, rm, etc. are implemented using <a href="https://en.wikipedia.org/wiki/BusyBox">BusyBox</a>.</p>

<ul>

<li><p>Using your favourite browser open the DSM management page and start the Package Center.</p>

</li>
<li><p>If you want to smoke test Perl, install <code>Perl</code>.</p>

</li>
<li><p>In Settings, add the following Package Sources:</p>

<pre><code class="plaintext">https://www.cphub.net
http://packages.quadrat4.de</code></pre>

</li>
<li><p>Still in Settings, in Channel Update, select Beta Channel.</p>

</li>
<li><p>Press Refresh. In the left panel the item &quot;Community&quot; will appear. Click it. Select &quot;Bootstrap Installer Beta&quot; and install it.</p>

</li>
<li><p>Likewise, install &quot;iPKGui Beta&quot;.</p>

<p>The application window should now show an icon for iPKGui.</p>

</li>
<li><p>Start iPKGui. Install the packages <code>make</code>, <code>gcc</code> and <code>coreutils</code>.</p>

<p>If you want to smoke test Perl, install <code>patch</code>.</p>

</li>
</ul>

<p>The next step is to add some symlinks to system libraries. For example, the development software expect a library <code>libm.so</code> that normally is a symlink to <code>libm.so.6</code>. Synology only provides the latter and not the symlink.</p>

<p>Here the actual architecture of the Synology system matters. You have to find out where the gcc libraries have been installed. Look in /opt for a directory similar to arm-none-linux-gnueab or powerpc-linux-gnuspe. In the instructions below I&#39;ll use powerpc-linux-gnuspe as an example.</p>

<ul>

<li><p>On the DSM management page start the Control Panel.</p>

</li>
<li><p>Click Terminal, and enable SSH service.</p>

</li>
<li><p>Close Terminal and the Control Panel.</p>

</li>
<li><p>Open a shell on the Synology using ssh and become root.</p>

</li>
<li><p>Execute the following commands:</p>

<pre><code class="plaintext">cd /lib
ln -s libm.so.6 libm.so
ln -s libcrypt.so.1 libcrypt.so
ln -s libdl.so.2 libdl.so
cd /opt/powerpc-linux-gnuspe/lib  (or
                                  /opt/arm-none-linux-gnueabi/lib)
ln -s /lib/libdl.so.2 libdl.so</code></pre>

</li>
</ul>

<p><b>WARNING:</b> When you perform a system software upgrade, these links will disappear and need to be re-established.</p>

<h3 id="DSM-6"><a class="permalink" href="perlsynology.html#DSM-6">#</a><a id="DSM1"></a>DSM 6</h3>

<p>Using iPkg has been deprecated on DSM 6, but an alternative is available for DSM 6: entware/opkg. For instructions on how to use that, please read <a href="https://github.com/Entware-ng/Entware-ng/wiki/Install-on-Synology-NAS">Install Entware-ng on Synology NAS</a></p>

<p>That sadly does not (yet) work on QorIQ. At the moment of writing, the supported architectures are armv5, armv7, mipsel, wl500g, x86_32, and x86_64. Check <a href="https://pkg.entware.net/binaries/">here</a> for supported platforms.</p>

<p>Entware-ng comes with a precompiled 5.24.1 (June 2017) that allowes building shared XS code. Note that this installation does <b>not</b> use a site_perl folder. The available <code>cpan</code> works. If all required development packages are installed too, also for XS.</p>

<h2 id="Compiling-Perl-5"><a class="permalink" href="perlsynology.html#Compiling-Perl-5">#</a><a id="Compiling"></a>Compiling Perl 5</h2>

<p>When the build environment has been set up, building and testing Perl is straightforward. The only thing you need to do is download the sources as usual, and add a file Policy.sh as follows:</p>

<pre><code># Administrivia.
perladmin=&quot;your.email@goes.here&quot;

# Install Perl in a tree in /opt/perl instead of /opt/bin.
prefix=/opt/perl

# Select the compiler. Note that there is no &#39;cc&#39; alias or link.
cc=gcc

# Build flags.
ccflags=&quot;-DDEBUGGING&quot;

# Library and include paths.
libpth=&quot;/lib&quot;
locincpth=&quot;/opt/include&quot;
loclibpth=&quot;/lib&quot;</code></pre>

<p>You may want to create the destination directory and give it the right permissions before installing, thus eliminating the need to build Perl as a super user.</p>

<p>In the directory where you unpacked the sources, issue the familiar commands:</p>

<pre><code class="plaintext">./Configure -des
make
make test
make install</code></pre>

<h2 id="Known-problems"><a class="permalink" href="perlsynology.html#Known-problems">#</a><a id="Known"></a>Known problems</h2>

<h3 id="Configure"><a class="permalink" href="perlsynology.html#Configure">#</a>Configure</h3>

<p>No known problems yet</p>

<h3 id="Build"><a class="permalink" href="perlsynology.html#Build">#</a>Build</h3>

<dl>

<dt id="Error-message-&quot;No-error-definitions-found&quot;."><a class="permalink" href="perlsynology.html#Error-message-%22No-error-definitions-found%22.">#</a><a id="Error"></a><a id="Error-message-No-error-definitions-found"></a>Error message &quot;No error definitions found&quot;.</dt>
<dd>

<p>This error is generated when it is not possible to find the local definitions for error codes, due to the uncommon structure of the Synology file system.</p>

<p>This error was fixed in the Perl development git for version 5.19, commit 7a8f1212e5482613c8a5b0402528e3105b26ff24.</p>

</dd>
</dl>

<h3 id="Failing-tests"><a class="permalink" href="perlsynology.html#Failing-tests">#</a><a id="Failing"></a>Failing tests</h3>

<dl>

<dt id="ext/DynaLoader/t/DynaLoader.t"><a class="permalink" href="perlsynology.html#ext/DynaLoader/t/DynaLoader.t">#</a><a id="ext"></a><a id="ext-DynaLoader-t-DynaLoader.t"></a><i>ext/DynaLoader/t/DynaLoader.t</i></dt>
<dd>

<p>One subtest fails due to the uncommon structure of the Synology file system. The file <i>/lib/glibc.so</i> is missing.</p>

<p><b>WARNING:</b> Do not symlink <i>/lib/glibc.so.6</i> to <i>/lib/glibc.so</i> or some system components will start to fail.</p>

</dd>
</dl>

<h2 id="Smoke-testing-Perl-5"><a class="permalink" href="perlsynology.html#Smoke-testing-Perl-5">#</a><a id="Smoke"></a>Smoke testing Perl 5</h2>

<p>If building completes successfully, you can set up smoke testing as described in the Test::Smoke documentation.</p>

<p>For smoke testing you need a running Perl. You can either install the Synology supplied package for Perl 5.8.6, or build and install your own, much more recent version.</p>

<p>Note that I could not run successful smokes when initiated by the Synology Task Scheduler. I resorted to initiating the smokes via a cron job run on another system, using ssh:</p>

<pre><code class="plaintext">ssh nas1 wrk/Test-Smoke/smoke/smokecurrent.sh</code></pre>

<h3 id="Local-patches"><a class="permalink" href="perlsynology.html#Local-patches">#</a><a id="Local"></a>Local patches</h3>

<p>When local patches are applied with smoke testing, the test driver will automatically request regeneration of certain tables after the patches are applied. The Synology supplied Perl 5.8.6 (at least on the DS413) <b>is NOT capable</b> of generating these tables. It will generate opcodes with bogus values, causing the build to fail.</p>

<p>You can prevent regeneration by adding the setting</p>

<pre><code class="plaintext">&#39;flags&#39; =&gt; 0,</code></pre>

<p>to the smoke config, or by adding another patch that inserts</p>

<pre><code>exit 0 if $] == 5.008006;</code></pre>

<p>in the beginning of the <code>regen.pl</code> program.</p>

<h2 id="Adding-libraries"><a class="permalink" href="perlsynology.html#Adding-libraries">#</a><a id="Adding"></a>Adding libraries</h2>

<p>The above procedure describes a basic environment and hence results in a basic Perl. If you want to add additional libraries to Perl, you may need some extra settings.</p>

<p>For example, the basic Perl does not have any of the DB libraries (db, dbm, ndbm, gdsm). You can add these using iPKGui, however, you need to set environment variable LD_LIBRARY_PATH to the appropriate value:</p>

<pre><code class="plaintext">LD_LIBRARY_PATH=/lib:/opt/lib
export LD_LIBRARY_PATH</code></pre>

<p>This setting needs to be in effect while Perl is built, but also when the programs are run.</p>

<h1 id="REVISION"><a class="permalink" href="perlsynology.html#REVISION">#</a>REVISION</h1>

<p>June 2017, for Synology DSM 5.1.5022 and DSM 6.1-15101-4.</p>

<h1 id="AUTHOR"><a class="permalink" href="perlsynology.html#AUTHOR">#</a>AUTHOR</h1>

<p>Johan Vromans &lt;jvromans@squirrel.nl&gt; H. Merijn Brand &lt;h.m.brand@xs4all.nl&gt;</p>


      </div>
      <div id="footer">
        <p>Perldoc Browser is maintained by Dan Book (<a href="https://metacpan.org/author/DBOOK">DBOOK</a>). Please contact him via the <a href="https://github.com/Grinnz/perldoc-browser/issues">GitHub issue tracker</a> or <a href="mailto:dbook@cpan.org">email</a> regarding any issues with the site itself, search, or rendering of documentation.</p>

<p>The Perl documentation is maintained by the Perl 5 Porters in the development of Perl. Please contact them via the <a href="https://github.com/Perl/perl5/issues">Perl issue tracker</a>, the <a href="https://lists.perl.org/list/perl5-porters.html">mailing list</a>, or <a href="https://kiwiirc.com/client/irc.perl.org/p5p">IRC</a> to report any issues with the contents or format of the documentation.</p>


      </div>
    </div>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.slim.min.js" integrity="sha512-/DXTXr6nQodMUiq+IUJYCt2PPOUjrHJ9wFrqpJ3XkgPNOZVfMok7cRw6CSxyCQxXn6ozlESsSh1/sMCTF1rL/g==" crossorigin="anonymous"></script>
    <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.16.1/umd/popper.min.js" integrity="sha512-ubuT8Z88WxezgSqf3RLuNi5lmjstiJcyezx34yIU2gAHonIi27Na7atqzUZCOoY4CExaoFumzOsFQ2Ch+I/HCw==" crossorigin="anonymous"></script>
    <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/js/bootstrap.min.js" integrity="sha384-B4gt1jrGC7Jh4AgTPSdUtOBvfO8shuf57BaghqFfPlYxofvL8/KUEfYiJOMMV+rV" crossorigin="anonymous"></script>
    <script src="../highlight.pack.js"></script>
    <script>hljs.highlightAll();</script>
  </body>
</html>
